home *** CD-ROM | disk | FTP | other *** search
/ Nebula 2 / Nebula Two.iso / Apps / ScreenSavers / darken / README < prev    next >
Text File  |  1995-06-12  |  2KB  |  55 lines
  1. The files in this archive provide a method for darkening the NeXT display
  2. completely when logging out.  This prevents burn-in of the login dialogue
  3. box.  This technique has been tested under NeXTStep 1.0 and 2.0.
  4.  
  5. To use the technique, follow these steps.
  6.  
  7. 1. Pick a place to install the VidLev program and the LoginHook and
  8.    LogoutHook shell scripts.  If you don't want to use /usr/local/etc,
  9.    modify the BIN string in Makefile to identify the installation path.
  10.    Make sure that the BIN path exists. 
  11.  
  12.    If you're using VidLev with a version of NeXTStep less than 3.0, you
  13.    will have to locate the evsio.h and video.h header files and change
  14.    their #include statements in VidLev.c.  For NeXTStep 2.1 they were:
  15.  
  16.     #include <nextdev/evsio.h>
  17.    and
  18.     #include <nextdev/video.h>
  19.  
  20.    Other header information from NeXTStep 2.1, missing from NeXTStep 3.0,
  21.    is defined in "missing.h".  (NeXTStep 3.0 is missing the <next/scr.h>
  22.    and <mon/nvram.h> header files.)
  23.  
  24.    If you're installing VidLev on an NFS client where the client root maps
  25.    to another UID on the server (e.g., to -2 for "nobody") you might have
  26.    to set the NOBODY string in the Makefile to the mapped UID.
  27.    
  28. 2. Become root and:
  29.  
  30.     # make install
  31.  
  32.    The install rule will compile VidLev, customize the LoginHook and
  33.    LogoutHook shell scripts, install all three, and set root's defaults
  34.    for the loginwindow program's login and logout hooks.
  35.  
  36.    Caution: if you already have root login hooks, the install rule will
  37.    over-write them.  If you don't want that to happen, do your own
  38.    login hook installation with dwrite.
  39.  
  40. 3. Reboot.  (This makes loginwindow aware of the login and logout hooks.)
  41.  
  42. When you log out the screen will darken completely.  You can rebrighten it
  43. by pressing the "brightness up" key on the NeXT keyboard (next to the
  44. "Power" key) -- moving the mouse or typing a login and password to the login
  45. dialogue box will not restore brightness until after the loginwindow manager
  46. has attempted to dim the login dialogue box (about 30 minutes after logoff).
  47. VidLev will darken the screen again every 10 minutes until someone logs on,
  48. so that loginwindow's post-logoff dimming won't accidentally raise the video
  49. level from VidLev's complete darkness to a dim login dialogue box level.  At
  50. login the LoginHook script sends a SIGHUP to the VidLev process and it
  51. restores screen brightness values to ones remembered from logout time.
  52.  
  53. Vic Abell <abe@mace.cc.purdue.edu>
  54. 30 October 1992
  55.